home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 1 / BBS in a box - Trilogy I.iso / Files / Publish / S / Sort Lines 2.00 Folder / Sort Lines Read Me < prev   
Encoding:
Text File  |  1993-06-25  |  3.2 KB  |  78 lines  |  [TEXT/R*ch]
  1.                                  Sort Lines External
  2.                                  ===================
  3.                                     version 2.00
  4.                                   Copyright © 1993
  5.                                    by Alex Maluta
  6.  
  7.  
  8. “Sort Lines Ext” is a BBEdit extension which will sort lines in a textfile. 
  9. The extension should work with BBEdit versions 2.1 and higher.  To install,
  10. place the “Sort Lines Ext” file into the “BBEdit Extensions” folder.
  11.  
  12. To use the extension, select the lines you want sorted and then choose “Sort
  13. Lines…” from the Extensions menu.  There are three ways to sort the selection:
  14.  
  15. Whole lines
  16. -----------
  17. This method will consider the contents of the entire line when sorting.
  18.  
  19. Character columns
  20. -----------------
  21. This method sorts entire lines, but only considers the characters between the
  22. specified columns when comparing lines.  This options is useful for sorting a
  23. table where columns are at fixed character positions.  To sort on the first two
  24. characters of a line, specify “columns #1 through #2”.
  25.  
  26. The “Sort Lines” extension has a shortcut which makes it easy to specify which
  27. columns you want sorted.  When selecting the lines to be sorted, start the
  28. selection just before the first column on the first line and extend the
  29. selection just past the last column on the last line to be sorted.  When you
  30. select the “Sort Lines” command the column numbers will automatically be filled
  31. in for you.
  32.  
  33. As an example, I find this option extremely useful in sorting the output from
  34. Think Pascal’s procedure profiler.  I open the output file in BBEdit; click to
  35. the right of the last digit in the “Total Time” column; scroll down to the
  36. bottom of the file; shift+click just to the right of the last digit in the “%
  37. Time” column; select “Sort Lines” and click on the “Character columns” option. 
  38. The profiler output is sorted by the “% Time” column.
  39.  
  40. Tab-delimited column
  41. --------------------
  42. This method also sorts entire lines, but only considers the characters of the
  43. tab-delimited column you specify.  Characters up to the first tab are
  44. considered column #1, the characters between the first and second tab are
  45. considered column #2 and so on.
  46.  
  47.  
  48. In each case, you may also check the “Descending order” checkbox which will
  49. reverse the sort order.
  50.  
  51. “Sort Lines” compares lines as plain text (it uses IUMagString).  This means
  52. that if you try to sort a column of numbers, “Sort Lines” will not work
  53. properly unless either all the numbers have the same number of characters, or 
  54. the numbers are right-justified and padded on the left with leading spaces.  
  55. If you need true numeric sorting, drop me a line and I’ll consider adding it
  56. for a future release.
  57.  
  58.  
  59. “Sort Lines Ext” is freeware, but I retain all rights to the program.  You may
  60. make and distribute copies of “Sort Lines Ext”, provided you include this
  61. documentation.  However, you may not sell or distribute “Sort Lines Ext” for
  62. profit, nor include it with other software which is sold or distributed for
  63. profit, without my written consent.
  64.  
  65. If you have any comments, feature requests or bug reports, I’d be interested in
  66. hearing from you at one of the E-Mail addresses below.
  67.  
  68. Enjoy!
  69.  
  70. Alex Maluta
  71.  
  72. Compuserve:     73457,1767
  73. America Online: AlexMaluta
  74. AppleLink:      AlexM
  75.  
  76. 6/20/93
  77.  
  78.